home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / clipper / ks94an.zip / CONVERT.HDR < prev    next >
Text File  |  1994-04-25  |  1KB  |  49 lines
  1. /******************************************************************************
  2.                  The Klipper Library, for CA-Clipper 5.x
  3.         Copyright (c), 1994, Wallace Information Systems Engineering
  4.  
  5. FUNCTION:
  6.  
  7. _Convert( cString, cException ) --> cString
  8.  
  9. PARAMETERS:
  10.  
  11. cString    : String to Convert
  12. cException : Character Exceptions
  13.  
  14. SHORT:
  15.  
  16. Strip all non-alphanumeric from a string (with optional exceptions).
  17.  
  18. DESCRIPTION:
  19.  
  20. _Convert() strips characters from a string, returning only the characters
  21. that are NOT included in:
  22.  
  23. Omit_Chars : <SPACE> _!$^*,-=+\|/`~{}.':<>%"&#@()`?][]
  24.  
  25. I.E., Convert strips all non-alphanumeric characters.
  26.  
  27. cException can be a string of characters to leave in the string. If
  28. cException = ' $()' then SPACE $, (, and ), will be left in the string, even
  29. though they normally would be removed, and all other punctuation marks in
  30. omit_chars will be removed.
  31.  
  32. cException is optional if unspecified, no exception is made.
  33.  
  34. NOTE:
  35.  
  36.  
  37.  
  38. EXAMPLE:
  39.  
  40. t = _Convert('A B C D E F G !$^*,-=+\|/`~{}()`?][]Z')
  41.  
  42. Result: t = 'ABCDEFGZ'
  43.  
  44. t = _convert( 'A B C D E F G !$^*,-=+\|/`~{}()`?][]Z', '$()' )
  45.  
  46. Result: t = 'ABCDEFG$()Z'
  47.  
  48. ******************************************************************************/
  49.